Operator AppletProperties

運算子庫:硬體平台

該 AppletProperties運算子沒有輸入,也沒有 輸出。它負責控制 Applet 以及電路板硬體的設定。

該運算子提供一組參數,用以 描述該小程式。其中部分值由使用者定義,其餘則由系統自動 產生。

此運算子在每個設計中皆為必備, 並由 `VisualApplets` 自動實例化。此運算子無法被刪除。

適用於硬體平台
imaFlex 2 Dual 100
imaFlex CXP-12 Penta
imaFlex CXP-12 Quad
mE5 marathon VCLx
mE5 marathon VCL
mE5 marathon VCX-QP
mE5 marathon VF2
LightBridge VCL
mE5 ironman VQ8-CXP6D
mE5 ironman VQ8-CXP6B
mE5 ironman VD8-PoCL
[注意] 可用參數

AppletProperties運算子為每個硬體平台提供一套 特定的參數。

以下參數說明指出哪些硬體平台支援哪些 參數。若未指定任何限制,則表示該參數在所有 平台上均受支援。

I/O Properties

Property Value
Operator Type 無(因為沒有輸入或輸出)

Supported Link Format

無

Parameters

VisualApplets 版本(所有平台)
Type 靜態讀取參數
Default 不適用
Range 不適用

所使用的VisualApplets 版本的版本號。

專案名稱(所有平台)
Type 靜態讀取參數
Default 不適用
Range 不適用

如選單中所示的專案名稱 「設計」選單中的 「屬性」選項。

AppletVersion(所有平台)
Type 靜態讀取參數
Default 不適用
Range 不適用

版本如「設計」選單中的 「屬性」選單項目所示。

AppletVendor(所有平台)
Type 靜態讀取參數
Default 不適用
Range 不適用

直接在該運算子的 「模組」屬性對話方塊中,您可以輸入 關於 Applet 供應商的資訊。

AppletAuthor(所有平台)
Type 靜態讀取參數
Default 不適用
Range 不適用

直接在該運算子的 「模組」屬性對話方塊中,您可以輸入 Applet 作者的相關資訊。

BuildTime(所有平台)
Type 靜態讀取參數
Default 不適用
Range 不適用

BuildTime 參數是一串自動生成的字串,顯示 該小程式何時被建置(最近一次產生網表的日期與時間)。

該參數值僅在「Framegrabber SDK 」中可見。下圖 顯示了該字串的格式:

AppletUid(所有平台)
Type 靜態讀取參數
Default 不適用
Range 不適用

Applet 的唯一識別碼。每次建立新版本時,都會產生一個新的識別碼(若已 設定先決條件檢查)。

FrontGpiPullControl03 / FrontGpiPullControl47(imaFlex 2 Dual 100 平台)
Type 動態、靜態寫入參數
Default PullUp
Range {PullUp, PullDown}

此參數用於控制前插槽 GPI 訊號的上拉與下拉電阻(20 kOhm), 無論其配置為 差分或單端模式。 您可以將 GPI 設定為 PullUp或 PullDown狀態。

拉高電阻用於定義當 GPI 接腳未 受到外部驅動,或當外部驅動器在幀 擷取器之後才通電時,該接腳的電壓水準。若連接了外部驅動器,其驅動能力必須足夠強大, 才能克服 20 kOhm 的拉高電阻。

FrontGpiPullControl03參數 用於控制 GPI 群組通道 A(GPI 引腳 0–3)的運作行為,而 FrontGpiPullControl47參數則用於控制 GPI 群組通道 B(GPI 引腳 4–7)的運作行為。

為了讓拉低電阻能正常運作,外部 GPIO 電源必須 連接至適當的連接器接腳(A 通道或 B 通道的 GPI 電壓輸入與 GPI 接地輸入)。

[注意] 可用性

imaFlex 2 Dual 100

FrontGpiType03 / FrontGpiType47(imaFlex 2 Dual 100 平台)
Type 動態、靜態寫入參數
Default 單端
Range {單端、差分}

此參數用於控制 GPI 接腳是以差分模式還是 單端模式運作。FrontGpiType03 參數負責管理群組通道 A(GPI 接腳 0–3),而 FrontGpiType47參數則負責管理群組 通道 B(GPI 接腳 4–7)。

在 單端 模式下,每個 GPI 接腳的訊號會 原樣傳入VisualApplets ,使得該群組中的所有四個接腳皆可 獨立使用。

在 差分 模式下,編號為偶數的 GPI 接腳 與緊接其後的奇數接腳會組合成一個差分通道, VisualApplets 。當差分模式啟用時,偶數接腳傳輸 差分訊號,而奇數接腳僅代表負對狀態, 可予以忽略。

[注意] 可用性

imaFlex 2 Dual 100

FiberPortProtocol0 / FiberPortProtocol1(imaFlex 2 Dual 100 平台)
Type 靜態寫入參數
Default

QSFP28[0]:CoF

QSFP28[1]:資料轉發

Range {CoF, DataForwarding}

此參數用於定義幀擷取卡上對應 QSFP28 埠的 光纖通訊協定。 埠 0 通常用於連接攝影機(CoF ), 而埠 1 則用於將資料轉發至另一台影像擷取卡。從屬影像 擷取卡的兩個埠通常均設定為 DataForwarding。

CoF 代表「光纖 CoaXPress」(CXP 3.0 標準)。DataForwarding是 Basler 開發的 用於幀擷取卡間通訊的協定。這兩種協定 均支援每通道 25 Gbit/s,因此每個 QSFP28 埠的傳輸速率可達 100 Gbit/s。

在特殊條件下,可將兩台 100 Gbit/s 攝影機連接至單一幀擷取卡 。此類配置需滿足特定要求 。 然而,幀擷取卡必須先進行預處理,並將 產生的頻寬至少減少一半,才能透過PCIe 將資料傳輸至 主機記憶體或GPU 。

PCIe 提供約 13 GB/s 的有效頻寬,而 單一 QSFP28 埠則提供約 12.5 GB/s。兩組 QSFP28 埠合計可產生 約 25 GB/s 的內部頻寬,若未經預處理與頻寬壓縮,此頻寬無法透過PCIe 傳輸。 此外,該板卡的 RAM 系統對可同時透過 RAM 傳輸的資料量施加了進一步的限制。

有關資料轉發功能的更多詳細資訊,請參閱《使用imaFlex 2 Dual 100 幀擷取卡進行資料轉發》。

[注意] 可用性

imaFlex 2 Dual 100

DesignClock(所有 imaFlex 平台)
Type 靜態讀取參數
Default 312.5
Range [312.5; 400.0]

此參數代表設計系統時鐘頻率(單位:兆赫)。 您可在VisualApplets 中,透過 「設計」選單下的「變更 FPGA 時鐘」選項來調整設計系統時鐘頻率。若設定較高的頻率(例如 135 MHz),可能會 導致時序違規。若發生此情況,請降低頻率。

[注意] 可用性

imaFlex 2 Dual 100, imaFlex CXP-12 Quad,imaFlex CXP-12 Penta

DesignClock(適用於 mE5marathon 及LightBridge VCL 平台)
Type 靜態讀取參數
Default 125
Range [125;312.5]

此參數代表設計系統時鐘頻率(單位:兆赫)。 您可在VisualApplets 中,透過 「設計」選單下的「變更 FPGA 時鐘」選項來調整設計系統時鐘頻率。若設定較高的頻率(例如 135 MHz),可能會 導致時序違規。若發生此情況,請降低頻率。

[注意] 可用性

mE5marathon VCLx、mE5marathon VCL、mE5marathon VCX-QP 、mE5marathon VF2、LightBridge VCL

ExtensionGpioType(imaFlex CXP-12 Quad 及imaFlex CXP-12 Penta 平台)
Type dynamic write parameter
Default OpenDrain
Range {開漏極、推拉式}

此參數可讓使用者選擇 外部擴充 GPIO 連接器的電路類型。在推挽模式下,GPIO 會被 直接驅動。

[注意] 此參數僅影響 GPIO 連接器

此參數對前置 GPIO 連接器沒有影響。僅有 GPIO 連接器會受到此參數的影響。

[注意] 可用性

imaFlex CXP-12 四埠版,imaFlex CXP-12 Penta

FrontGpioPullControl(imaFlex CXP-12 Penta 平台)
Type dynamic write parameter
Default PullUp
Range {PullUp, PullDown}

  • 上拉電阻:所有前端 GPIO 輸入端均啟用上拉電阻 並連接至 SLTRG_VIN(外部 5–24 V 輸入參考電壓)。

  • 下拉電阻:所有前端 GPIO 輸入端均啟用 下拉電阻,將其拉至 SLTRG_GND(隔離接地)。

[注意] 可用性

imaFlex CXP-12 Penta

FrontGpioType(imaFlex CXP-12 Penta 平台)
Type dynamic write parameter
Default 單端
Range {單端、差分}

  • 差分:所有前端 GPIO 輸入皆為差分式。

  • 單端:所有前端 GPIO 輸入皆為單端(以 SLTRG_GND 為基準)。

[注意] 可用性

imaFlex CXP-12 Penta

FrontGpioInversion(imaFlex CXP-12 Penta 平台)
Type dynamic write parameter
Default 關閉
Range {開啟、關閉}

  • 啟用時:所有前端 GPIO 輸出與 FPGA 輸出相比,極性相反。

  • 關閉:所有前端 GPIO 輸出與 FPGA 輸出的極性相同。

[注意] 可用性

imaFlex CXP-12 Penta

PcieInterfaceType(ironman 平台)
Type 靜態寫入參數
Default 第二代
Range {第一代, 第二代}

透過參數 PcieInterfaceType,您可以選取PCIe 介面 類型,從而設定所支援的 DMA 頻寬。

Generation_2(預設)代表PCIe 第2代通訊協定, 並提供3,600,000位元組/秒的頻寬。

Generation_1 代表PCIe 第一代通訊協定,並提供 1,800,000 位元組/秒的頻寬。

第一代設計所使用的 FPGA 資源略少。採用第一代設計時, 要讓小程式達到時序收斂要容易得多。 Generation_2 雖能提供最佳效能,但使得 小程式的時序收斂更加困難。為滿足時序要求, 可能需要進行多次佈置與佈線合成運算。

[注意] 可用性

mE5ironman VD8-PoCL 、 mE5ironman VQ8-CXP6D 以及 mE5ironman VQ8-CXP6B

PcieInterfaceType(適用於 mE5marathon 及LightBridge VCL 平台)
Type 靜態寫入參數
Default 第二代
Range {第一代, 第二代}

透過參數 PcieInterfaceType,您可以選取PCIe 介面 類型,從而設定所支援的 DMA 頻寬。

Generation_1: The applet only supports PCIE generation 1. Thus, the maximum DMA transmission bandwidth is ca. 900 MByte/s (1MByte = 1^10Byte). The DmaToPC operator is limited so that LinkParallelism x LinkPixelWidth needs to be <= 64 bit.

Generation_2: The applet supports PCIE generation 2. Thus, the maximum DMA transmission bandwidth is ca. 1800 MByte/s (1MByte = 1^10Byte). The DmaToPC operator is limited so that LinkParallelism x LinkPixelWidth needs to be <= 128 bit.

Generation_1 的實作所消耗的資源比 Generation_2 的實作更少。Generation_1 模式對於那些 不需要 Generation_2 的高頻寬,但資源有限的設計而言,相當有用。

[注意] 可用性

mE5marathon VCLx、mE5marathon VCL、mE5marathon VCX-QP 、mE5marathon VF2,以及LightBridge VCL。

GpioType(適用於 mE5marathon 及ironman 平台)
Type dynamic write parameter
Default OpenDrain
Range {開漏極、推拉式}

此參數可讓使用者選擇 外部 GPIO 連接器的電路類型。在推拉模式下,GPIO 會被直接驅動。

[注意] 此參數僅影響 GPIO 連接器

此參數對前置 GPIO 連接器沒有影響。僅有 GPIO 連接器會受到此參數的影響。

[注意] 可用性

mE5marathon VCLx、mE5marathon VCL、mE5marathon VCX-QP 、mE5marathon VF2、mE5ironman VD8-PoCL 、mE5ironman VQ8-CXP6D ,以及 mE5ironman VQ8-CXP6B

BuildTimeStamp(所有平台 - 隱藏)
Type 靜態寫入參數
Default 不適用
Range 不適用
[注意] 可見度

此參數不會顯示在操作員的參數清單中。

然而,該參數在執行環境中是可見的。

BuildTimeStamp 是一個自動生成的識別號碼。它是一個 32 位元的時間戳記,可在執行期間從小程式中讀取,用以檢查 已載入的小程式與其執行 環境之間的一致性。

ProjectNameHash(所有平台 - 隱藏)
Type 靜態讀取參數
Default 不適用
Range 不適用
[注意] 可見度

此參數不會顯示在操作員的參數清單中。

然而,該參數在執行環境中是可見的。

ProjectName 中的項目所產生的 32 位元雜湊值(選單「設計」,選單項目 「屬性」)。此值可在執行期間從小程式中讀取,以 檢查已載入的小程式與其執行環境 之間的一致性。

AppletUidHigh(所有平台 - 隱藏)
Type 靜態讀取參數
Default 不適用
Range 不適用
[注意] 可見度

此參數不會顯示在操作員的參數清單中。

然而,該參數在執行環境中是可見的。

參數 AppletUid 代表一個 128 位元的數值。此 數值的最高 64 位元會以 AppletUidHigh 中的數值呈現。

AppletUidLow(所有平台 - 隱藏)
Type 靜態讀取參數
Default 1
Range {0; 2^32 – 1}
[注意] 可見度

此參數不會顯示在操作員的參數清單中。

然而,該參數在執行環境中是可見的。

參數 AppletUid 代表一個 128 位的數值。此數值的 低 64 位元會以 AppletUidLow 中的數值形式呈現。

Examples of Use

以下範例展示了 AppletProperties 運算子的使用方式: